获取订单详情 | 商户->百度
更新时间:2024-05-09
获取订单详情
接口描述
本接口用于查询当前订单详情,无缓存
接口地址:https://maphotel.baidu.com/map_mc/order/orderDetail 请求方式:POST
权限说明
注意事项
- 超时时间:要求接口耗时小于1.5S(超过1.5S触发超时重试),重试策略:1次/2分钟,累计次数200次。
- 返回值判断:
a.返回数据格式:json,包含字段如:{"errno":0,"msg":"success","data":{}}
请求参数
参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
---|---|---|---|---|
bd_pay_order_id | String | 是 | RequestBody参数 | 百度支付单号 |
tp_order_id | String | 是 | RequestBody参数 | 商户订单号 |
响应参数
参数名称 | 父节点 | 类型 | 是否必传 | 描述 |
---|---|---|---|---|
errno | 无 | int | 是 | 错误码,0:成功 |
msg | 无 | string | 是 | 结果描述,success:成功 |
data | 无 | json | 是 | 预定结果 |
bdOrderId | data | string | 是 | 百度支付订单号 |
orderTitle | data | string | 是 | 订单名称 |
tpStatus | data | string | 是 | 订单状态,码表 |
tplStatus | data | string | 是 | 订单状态 |
payAmount | data | string | 是 | 支付金额,分 |
discountAmount | data | string | 否 | 补贴金额,分 |
customerRealname | data | string | 否 | 入住人名称,加密 |
roomDetail | data | string | 否 | 房间详情 |
roomDetail.name | data | string | 否 | 房型 |
roomDetail.amount | data | string | 否 | 间数 |
roomDetail.checkin | data | string | 否 | 入住时间,时间戳,秒 |
roomDetail.checkout | data | string | 否 | 离店时间,时间戳,秒 |
请求示例
{
"tp_name":"test",
"salt":681161,
"timestamp":1648642558,
"sign":"ca852a6df07aa4653d1d0848bd893247",
"bd_pay_order_id":"test_1509118392932671488"
}
响应示例
{
"errno": 0,
"errstr": "",
"desc": "操作成功",
"data": {
"bdOrderId": "test_1509118392932671488",
"orderTitle": "城市便捷酒店(仙葫大道店)",
"tplStatus": "已完成",
"tpStatus": "10",
"payAmount": "18100",
"discountAmount": "600",
"customerRealname": "8wb40QVMNPiqIjBeIWzFZg",
"roomDetail": {
"name": "高级大床房",
"amount": 1,
"checkin": 1651680000,
"checkout": 1651809600
}
}
}
tpStatus订单状态码表
取值 | 释义 | 描述 |
---|---|---|
1 | 待支付 | 未支付 |
2 | 支付超时 | 半小时未支付订单 |
3 | 确认中 | 支付成功,酒店确认中 |
7 | 预定失败 | 酒店预定失败 |
8 | 待入住 | 酒店预定成功 |
10 | 已完成 | 已离店并核销 |
11 | 已取消 | 订单已取消 |
13 | 退款中 | |
14 | 退款成功 | 全额退款 |
15 | 退款成功 | 部分退款 |
16 | 退款审核中 | 商户已推送退款,待客服审核中 |
17 | 取消中 | 取消中,等待商户推送取消结果 |
18 | 取消成功 | 取消成功后会自动退款 |
19 | 取消失败 | 取消失败,订单会重新流转到待入住 |
错误码
errno | 描述 | 处理 |
---|---|---|
0 | 成功 | |
1000 | 参数错误 | 检查加密参数与必传参数是否有误 |
2100 | order no exists | 订单不存在 |